/*
 * Copyright (C), 2014-2016, org.esaydev
 * FileName: UserApi.java
 * Author:   jian
 * Date:     2016年3月24日 
 */
package org.easydev.wechat.api;

import org.easydev.wechat.client.dto.user.UserInfo;
import org.easydev.wechat.client.result.user.WechatUser;
import org.easydev.wechat.common.exception.WechatException;

/**
 * <Description>用户接口 <br>
 * 
 * @author jian<br>
 */
public class UserAPI extends SystemAPI {

    /**
     * Description:查询用户信息 <br>
     * <br>
     * 开发者可通过OpenID来获取用户基本信息。<br>
     * 特别需要注意的是，如果开发者拥有多个移动应用、网站应用和公众帐号，<br>
     * 可通过获取用户基本信息中的unionid来区分用户的唯一性，<br>
     * 因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号，用户的unionid是唯一的。<br>
     * 换句话说，同一用户，对同一个微信开放平台下的不同应用，unionid是相同的。<br>
     * 
     * @throws WechatException
     */
    public static WechatUser getUserInfo(UserInfo ui) throws WechatException {
        return client.getFromWechat(ui).getData(WechatUser.class);
    }
}
